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READ THIS DOCUMENT BEFORE ATTEMPTING TO USE THE OBJECT KIT. 
THIS DOCUMENT DESCRIBES THE DNCS/SNA EMULATOR RELEASE 1.0 
OBJECT INSTALLATION MEDIA, PART NUMBER 2308308-1601 (DISK OR 
TAPE) OR 2308308-1602 (DISKETTE) . REFER TO THE RELEASE 
INFORMATION, PART NUMBER 2308310-9901 FOR ADDITIONAL 
INFORMATION. 



TEXAS INSTRUMENTS ASSUMES NO RESPONSIBILITY FOR MODIFICATIONS 
MADE TO THIS OBJECT KIT. 
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Section 1 
Introduction 



1.1 GENERAL INFORMATION 

This document describes the installation of the DNCS/SNA Emulator 
object package under DNOS. The media must be restored to disk 
(if supplied on magnetic tape) or used directly (if supplied on 
disk or diskette) . 

Be sure to copy and/or write protect the installation media. For 
copy procedures, refer to the Model 990 Computer DNOS Operations 
Guide , part number 2270502-970X1 

Consult the Release Information for additional information 
concerning the current release. 

This document presents many System Command Interpreter (SCI) 
commands in batch format. You can use these commands either by 
entering the entire command as shown or by entering only the 
command keyword and responding to the interactive prompts. For a 
discussion of the batch command format, refer to the Model 990 
Computer DNOS System Command Interpreter (SCI) Reference Manual , 
part number 2270503-9701. 



1.2 MEDIA DEFINITION 

Product shipments are made in the following formats: 

* Disk — A DS10, DS50, DS200, or CD1400 disk containing 
the object 

* Diskette — A double-sided, double-density (DSDD) 
diskette containing the object 

* Magnetic Tape — An 800 or 1600 bits-per-inch (bpi) 
magnetic tape containing the object 

* Add-On — A disk containing the object and one or more 
other products 
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1.3 INSTALLATION OVERVIEW 

The installation process described in this document provides the 
steps required to install the DNCS/SNA Emulator object. These 
procedures are outlined as follows: 

* Install the DNCS/SNA station tasks. 

* Patch the DNCS/SNA station tasks. 

* Generate the DNCS/SNA Programmed Station Control (PSC) 
tasks. 

* Install the DNCS/SNA PSC tasks. 

* Patch the DNCS/SNA PSC tasks. 



1.4 SYSTEM REQUIREMENTS 

To perform these installation procedures successfully, you must 
have DNOS (Release 1.0.0 or later) running on a Model 990/10 or 
990/12 Computer with at least 512K bytes of memory. 
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Section 2 
Preparing for Installation 



2 . 1 GENERAL 

The DNCS/SNA Emulator object is shipped on various media and must 
be prepared prior to installation. This section describes how to 
prepare each type of media. 



2.2 DOUBLE-SIDED, DOUBLE-DENSITY (DSDD) DISKETTE FORMAT 

When you receive the object on DSDD diskette, perform the 
following steps to prepare it for installation: 

1. Load the DNCS/SNA Emulator object diskette DCEMO in an 
available drive and make it ready. Disable the 
diskette write protection. 

2. Install the diskette volume by using the Install Volume 
(IV) command as follows: 

IV U=<dsxx>, V=DCEMO 

where : 

<dsxx> is the name of the drive where the diskette is 
loaded . 

3. Proceed to paragraph 3.1 to continue the installation. 



2.3 DISK FORMAT 

When you receive the object on disk, perform the following steps: 

1. Load the DNCS/SNA Emulator object disk DCEMO in an 
available drive and make it ready. Disable the disk 
write protection. 
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2. Install the disk volume by using the IV command as 
follows: 

IV U=<dsxx>, V=DCEMO 

where : 

<dsxx> is the name of the drive where the disk is 
loaded. 

3. Proceed to paragraph 3.1 to continue the installation. 



2.4 MAGNETIC TAPE FORMAT 

When you receive the object on magnetic tape, copy it to a disk 
as follows: 

1. Create the DNCS/SNA Emulator object directory on an 
available disk by using the CDFIR command as follows: 

CFDIR P=<dncsvolume>. DCEMO, M=50 

where : 

<dncsvolume> is the name of the disk where you create 
the directory. 

2. Assign the synonym DCEMO to the DNCS/SNA Emulator 
object directory by using the Assign Synonym (AS) 
command as follows: 

AS S=DCEMO, V=<dncsvolume>. DCEMO 

where : 

<dncsvolume> is the name of the disk that contains the 
DNCS/SNA Emulator object directory. 

3. Mount the magnetic tape on an available tape drive and 
make it ready. Enable the tape write protection. 
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4. Copy the contents of the tape to the DNCS/SNA Emulator 
object directory by using the Restore Directory (RD) 
command as follows: 

RD S=<mtxx>, D=DCEMO, L=. LI STING 

where: 

<mtxx> is the name of the drive where the tape is 
mounted. 

The file .LISTING contains a listing of the directory 
restored from magnetic tape. Check this file for 
errors by using a Show File (SF) or Print File (PF) 
command. 

5. Unload the tape. 

6. Proceed to paragraph 3.1 to continue the installation. 



2.5 ADD-ON FORMAT 

When you receive the object as an add-on , perform the following 
steps: 

1. If you receive the DNCS/SNA Emulator object add-on on 
the system disk and the system is running under that 
disk, then assign the synonym DCEMO to the DNCS/SNA 
Emulator object directory by using the AS command as 
follows: 

AS S=DCEMO, V=. DCEMO 

Proceed to paragraph 3.1 to continue the installation. 

2. If you receive the DNCS/SNA Emulator object add-on on a 
secondary disk, then load this disk in an available 
drive and make it ready. Disable the disk write 
protection. 
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3. Install the disk volume by using the IV command as 
follows: 

IV U=<dsxx>, V=<dncsvolume> 

where: 

<dsxx> is the name of the drive where the disk 
is loaded. 

<dncsvolume> is the volume name of the add-on disk. 

4. Assign the synonym DCEMO to the DNCS/SNA Emulator 
object directory by using the AS command as follows: 

AS S=DCEMO, V=<dncsvolume>. DCEMO 

where: 

<dncsvolume> is the name of the disk that contains the 
DNCS/SNA Emulator object directory. 

5. Proceed to paragraph 3.1 to continue the installation. 
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Section 3 
Installing the DNCS/SNA Emulator Tasks 



3.1 GENERAL 

The procedures in this section describe how to install and patch 
the DNCS/SNA Emulator tasks. 



3.2 INSTALLING THE EMULATOR TASKS 

Perform the following steps to install the DNCS/SNA Emulator 
tasks: 

1. Enter the following command to access the DNCS/SNA 
Emulator object installation SCI procedures: 

.USE DC EMO. RELEASE. PROC,.S$CMDS 

2. Install the DNCS/SNA Emulator tasks on a DNCS system by 
using the Install DNCS/SNA Emulator Tasks (INSEM) 
command as follows: 

[] INSEM 

INSTALL DNCS/SNA EMULATOR TASKS 

DNCS/SNA EMULATOR DIRECTORY: DCEMO 
DNCS SYSTEM VOLUME: 
DNCS COMMAND DIRECTORY: 

DNCS/SNA EMULATOR DIRECTORY 

Enter the directory name where the DNCS/SNA 
Emulator object directory resides. The proper 
response is DCEMO. 

DNCS SYSTEM VOLUME 

Enter the directory (or volume) name where the 
DNCS Nucleus program file .S$DNCS.PGMTASK resides. 
This must be the same system volume entered in the 
INSFW command described in the DNCS Nucleus task 
installation. 
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DNCS COMMAND DIRECTORY 

Enter the directory name where you want to install 
the DNCS/SNA Emulator SCI procedures. This name 
must be the same as the command directory entered 
in the Install DNCS Nucleus Tasks (INSFW) command 
described in the DNCS Nucleus Object Installation 
part number 2302660-97Tm 

3. The following messages are displayed at the station 
after you enter INSEM. Respond to each message by 
pressing RETURN. 

BATCH LISTING FILE WILL BE...: 

" <dcemo> .BL . INSEM' : 
where: 
<dcemo> is the value of the synonym DCEMO. 

4. Wait for INSEM to complete by using the Waiting for 
Background Task to Complete (WAIT) command as follows: 

[]WAIT 

5. When INSEM completes, the following * message is 
displayed at the station: 

BATCH SCI HAS COMPLETED 

Press the RETURN key to display the following 
additional message: 

x ERRORS IN INSEM BATCH STREAM: 

If the number of errors reported is nonzero, examine 
the file <dcemo>.BL. INSEM by using a Show File (SF) 
command to determine the cause of the error (s). 
Correct the error (s) and reenter INSEM. 
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3.3 PATCHING THE DNCS/SNA EMULATOR TASKS 

Perform the following steps to patch the DNCS/SNA Emulator tasks: 

1. Patch the DNCS/SNA Emulator tasks by using the Patch 
DNCS/SNA Emulator Tasks (PATEM) command as follows: 

[ ] PATEM 

PATCH DNCS/SNA EMULATOR TASKS 

DNCS/SNA EMULATOR DIRECTORY: DCEMO 
DNCS SYSTEM VOLUME: 
DNCS PATCH DIRECTORY: 

DNCS/SNA EMULATOR DIRECTORY 

Enter the directory name where the DNCS/SNA 
Emulator object directory resides. The default is 
DCEMO, the value entered in the INSEM command. 

DNCS SYSTEM VOLUME 

Enter the directory (or volume) name where the 
DNCS Nucleus program file .S$DNCS.PGMTASK resides. 
The default is the value entered in the INSEM 
command . 

DNCS PATCH DIRECTORY 

Enter the directory name where the patch sub- 
directories reside. The standard response is 
DCEMO. Otherwise, enter the directory name 
containing the .PATCH directory. 

2. The following messages are displayed at the station 
after PATEM is entered. Respond to each message by 
pressing RETURN. 

BATCH LISTING FILE WILL BE...: 



* <dcpat>. PATCH. LSTEM': 

where: 

<dcpat> is the value entered for the DNCS 
DIRECTORY prompt (synonym expanded) . 



PATCH 



3. Wait for PATEM to complete by using the WAIT command as 
follows: 

[]WAIT 
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4. When PATEM completes, the following message is 
displayed at the station: 

x ERRORS IN DNCS/SNA EMULATOR PATCH STREAM: 

If the number of errors reported is nonzero, examine 
the file <dcpat>. PATCH. LSTEM by using an SF command to 
determine the cause of the error (s). Correct the 
error (s) and reenter PATEM. 

5. Proceed to paragraph 4.1 to continue the installation. 
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Section 4 
Installing the Programmed Station Control Tasks 



4 . 1 GENERAL 

This section describes the procedures used to generate the 
DNCS/SNA Programmed Station Control (PSC) tasks, install the 
tasks on a DNOS system, and patch the tasks. Skip this section 
if the DNCS/SNA PSC tasks are not required. The generation 
process requires that the DNCS generation directory be accessible 
for the particular configuration. This directory is built during 
the DNCS Nucleus task generation as described in the DNCS Nucleus 
Object Installation . 



4.2 GENERATING THE DNCS/SNA PSC TASKS 

Perform the following steps to generate the DNCS/SNA PSC tasks: 

1. Enter the following command to access the DNCS/SNA 
Emulator object installation SCI procedures: 

.USE DCEMO. RELEASE. PROC,.S$CMDS 

2. Assemble and link the DNCS/SNA PSC tasks by using the 
Assemble and Link DNCS PSC Tasks (ALPSC) command as 
follows: 

[ ] ALPSC 

ASSEMBLE AND LINK DNCS PSC TASKS 

DNCS/SNA EMULATOR DIRECTORY: DCEMO 
DNCS GENERATION DIRECTORY: 
CONFIGURATION: 

DNCS/SNA EMULATOR DIRECTORY 

Enter the directory name where the DNCS/SNA 
Emulator object directory resides. The default is 
DCEMO, the value entered in the INSEM command. 
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DNCS GENERATION DIRECTORY 

Enter the directory name where the DNCS 
configuration file resides. The proper response 
is the value entered for the DNCS GENERATION 
DIRECTORY prompt in the Execute DNCS System 
Generation Utility (XDGU) command described in the 
DNCS Nucleus task installation procedure. 

CONFIGURATION 

Enter the name of the DNCS configuration. The 
proper response is the value entered for the 
OUTPUT CONFIGURATION prompt in the XDGU command 
described with DNCS Nucleus task installation. 

3. The following messages are displayed at your station 
after you enter ALPSC. Respond to each message by 
pressing RETURN. 

BATCH STATUS FILE WILL BE...: 

'<CUStom>.LIST.PSCLOG' : 

where: 

<custom> is the pathname defined by the concatenation 
of the DNCS GENERATION DIRECTORY response, 
the value .S$DGU$, and the CONFIGURATION 
response. 

4. Wait for ALPSC to complete by using the Waiting for 
Background Task to Complete (WAIT) command as follows: 

[]WAIT 



5. When ALPSC completes, the 
displayed at the station: 



following message is 



BATCH SCI HAS COMPLETED 



Press the RETURN 
additional message: 



key to receive the following 



===>x ERRORS IN ALPSC BATCH STREAM: 

If the number of errors reported is nonzero, examine 
the files <custom>.LIST.PSCLOG and <custom> .LIST. ALPSC 
by using a Show File (SF) command to determine the 
cause of the error (s). Correct the error (s) and 
reenter ALPSC. 



4-2 



2302636-9701 



DNCS/SNA Emulator Object Installation Installing PSC Tasks 



4.3 INSTALLING THE DNCS/SNA PSC TASKS 

Perform the following steps to install the DNCS/SNA PSC tasks. 

1. Install the DNCS/SNA PSC tasks on a DNOS system by 
using the Install DNCS PSC Tasks (INSPSC) command as 
follows: 

[] INSPSC 

INSTALL DNCS PSC TASKS 

DNCS/SNA EMULATOR DIRECTORY: DCEMO 

DNCS GENERATION DIRECTORY: 

CONFIGURATION: 

DNOS SYSTEM VOLUME: 

DNCS COMMAND DIRECTORY: 

DNCS/SNA EMULATOR DIRECTORY 

Enter the directory name where the DNCS/SNA 
Emulator object directory resides. The default is 
DCEMO, the value entered in the ALPSC command. 

DNCS GENERATION DIRECTORY 

Enter the directory name where the DNCS 
configuration file resides. The default is the 
value entered in the ALPSC command. 

CONFIGURATION 

Enter the name of the DNCS configuration. The 
default is the value entered in the ALPSC command. 

DNOS SYSTEM VOLUME 

Enter the directory (or volume) name where the 
.S$UTIL program file resides. 

DNCS COMMAND DIRECTORY 

Enter the directory name where you want to install 
the DNCS/SNA PSC SCI . procedures. This name 
must be the same command directory entered in the 
INSFW command described with DNCS Nucleus task 
installation. 
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2. The following messages are displayed at the station 
after you enter INSPSC. Respond to each message by 
pressing RETURN. 

BATCH LISTING FILE WILL BE...: 

' <custom> . LIST . INSPSC : 

where : 

<custom> is the pathname defined by the concatenation 
of the DNCS GENERATION DIRECTORY response, 
the value .S$DGU$ f and the CONFIGURATION 
response. 

3. Wait for INSPSC to complete by using the WAIT command 
as follows: 

[]WAIT 

4. When INSPSC completes, the following message is 
displayed at the station: 

BATCH SCI HAS COMPLETED 

Press the RETURN key to receive the following message: 

x ERRORS IN INSPSC BATCH STREAM: 

If the number of errors reported is nonzero, examine 
the file <custom>. LIST. INSPSC by using an SF command to 
determine the cause of the error (s). Correct the 
error (s) and reenter INSPSC. 



4.4 PATCHING THE DNCS/SNA PSC TASKS 

Perform the following steps to patch the DNCS/SNA PSC tasks. 

1. Patch the DNCS/SNA PSC tasks by using the Patch DNCS 
PSC Tasks (PATPSC) command as follows: 

[ ] PATPSC 

PATCH DNCS PSC TASKS 

DNCS/SNA EMULATOR DIRECTORY: DCEMO 
DNCS GENERATION DIRECTORY: 
CONFIGURATION: 
DNOS SYSTEM VOLUME: 
DNCS PATCH DIRECTORY: DCEMO 
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DNCS/SNC EMULATOR DIRECTORY 

Enter the directory name where the DNCS/SNA 
Emulator object directory resides. The default is 
DCEMO, the value entered in the INSPSC command. 

DNCS GENERATION DIRECTORY 

Enter the directory name where the DNCS 
configuration file resides. The default is the 
value entered in the INSPSC command. Otherwise, 
enter the directory name containing the .S$DGU$ 
directory. 

CONFIGURATION 

Enter the name of the DNCS configuration. The 
default is the value entered for INSPSC. 

DNOS SYSTEM VOLUME 

Enter the directory (or volume) name where the 
.S$UTIL program file resides. 

DNCS PATCH DIRECTORY 

Enter the directory name where the patch sub- 
directories reside. The standard response is 
DCEMO. Otherwise, enter the directory name 
containing the .PATCH directory. 

The following messages are displayed at the station 
after PATPSC is entered. Respond to each message by 
pressing RETURN. 

BATCH LISTING FILE WILL BE...: 

'<dcpat>. PATCH. LSTPSC': 

where: 

<dcpat> is the value entered for the DNCS PATCH 
DIRECTORY prompt. 

Wait for PATPSC to complete by using the WAIT command 
as follows: 

[]WAIT 

When PATPSC completes, the following message is 
displayed at the station: 

X ERRORS IN PSC EMULATOR PATCH STREAM: 

If the number of errors reported is nonzero, examine 
the file <dcpat>. PATCH. LSTPSC by using an SF command to 
determine the cause of the error (s). Correct the 
error (s) and reenter PATPSC. 
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4.5 COMPLETING THE TASK INSTALLATION 

Perform an initial program load (IPL) in order to load the 
DNCS/SNA PSC memory resident tasks into memory. 
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